SftTree/OCX 7.0

SftTree.VirtualImageSizes Method

Softel vdm, Inc.

Defines the maximum graphics sizes when using a virtual data source.

Syntax       

VB.NET

object.VirtualImageSizes(ByVal ItemImageWidth As Integer, ByVal ItemImageHeight As Integer, ByVal CellImageWidth As Integer, ByVal CellImageHeight As Integer, ByVal LabelImageWidth As Integer, ByVal LabelImageHeight As Integer, ByVal RowHeaderImageWidth As Integer, ByVal RowHeaderImageHeight As Integer)

VB

object.VirtualImageSizes(ByVal ItemImageWidth As Integer, ByVal ItemImageHeight As Integer, ByVal CellImageWidth As Integer, ByVal CellImageHeight As Integer, ByVal LabelImageWidth As Integer, ByVal LabelImageHeight As Integer, ByVal RowHeaderImageWidth As Integer, ByVal RowHeaderImageHeight As Integer)

C#.NET

void object.VirtualImageSizes(int ItemImageWidth, int ItemImageHeight, int CellImageWidth, int CellImageHeight, int LabelImageWidth, int LabelImageHeight, int RowHeaderImageWidth, int RowHeaderImageHeight);

VC++

HRESULT object->VirtualImageSizes(int ItemImageWidth, int ItemImageHeight, int CellImageWidth, int CellImageHeight, int LabelImageWidth, int LabelImageHeight, int RowHeaderImageWidth, int RowHeaderImageHeight);

C

HRESULT object->raw_VirtualImageSizes(int ItemImageWidth, int ItemImageHeight, int CellImageWidth, int CellImageHeight, int LabelImageWidth, int LabelImageHeight, int RowHeaderImageWidth, int RowHeaderImageHeight);

Delphi

procedure object.VirtualImageSizes(ItemImageWidth : Integer, ItemImageHeight : Integer, CellImageWidth : Integer, CellImageHeight : Integer, LabelImageWidth : Integer, LabelImageHeight : Integer, RowHeaderImageWidth : Integer, RowHeaderImageHeight : Integer);

object

A SftTree object.

ItemImageWidth

The maximum width of an item graphic.  0 can be specified if item graphics are not used. 

ItemImageHeight

The maximum height of an item graphic.  0 can be specified if item graphics are not used.

CellImageWidth

The maximum width of a cell graphic.  0 can be specified if cell graphics are not used.

CellImageHeight

The maximum height of a cell graphic.  0 can be specified if cell graphics are not used.

LabelImageWidth

The maximum width of a label graphic.  0 can be specified if label graphics are not used.

LabelImageHeight

The maximum height of a label graphic.  0 can be specified if label graphics are not used.

RowHeaderImageWidth

The maximum width of a row header graphic.  0 can be specified if row headers are not used.

RowHeaderImageHeight

The maximum height of a row header graphic.  0 can be specified if row headers are not used.

Comments

The VirtualImageSizes method defines the maximum graphics sizes when using a virtual data source.

After defining a tree control as a virtual tree control using the VirtualMode property, the (maximum) graphics sizes must be defined using the VirtualImageSizes method, so the graphics are enabled and so the control can reserve sufficient space for each graphics component.

In a fixed height tree control, VirtualImageSizes defines the exact size of each graphics component.  In a variable height tree control, the graphics must define the maximum size of each graphics component.

If a graphic component is not used, 0 can be specified as its height and width.  In this case the graphic component is not displayed even if the virtual data source callback provides a valid image.

If the tree control is not a virtual tree control (items have been added using Items.Add or Items.Insert), this method will fail. 

See Also  SftTree Object | Object Hierarchy


Feedback / comments / error reports for this topic
© 2015 - Softel vdm, Inc. - www.softelvdm.com